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H3 Hsy Fsotufss Overview 



Hie H3 software 5^5tsft provides 3 cofsion bDot^le diskette for all 
Hici^nenqiriB prGduct lines: SBl600t HE16CG, and ^00900* The opertfting 
5'-j:-:te?5 dees this bn interroostirfq the hardware confiourstion it is 
nrrnino on -sTid confiqures the software systen aceordiriqiy* Note in order 
tc achieve a com^\ object the H3 bootstrap differs frcH previous beets * 
TI~ersfQre only H3 level bootstraps will york j4ith the H3 release* See 
Section 6.2? 5,3 and Apperidix G of the in«0 Qperating S'-jsted Refer^c-e 
Hanual (111*0 Softioa^rs lianual) for Hore details coreerniriq the H3 bootstrap 
ssQijerice* 

Softyare support for 881608 series* 

a) S*=r-i3l port B baud rate is software selectable U5iri<5 SetLsp to control 
the fisid 'BMJORATE'* 

b) ^oftw^re floppH disk, sirtqie-double derisit'j selection* This irciitdes 
autoptetic boot up of either single or double density diskettes* In 
addition durinq rior-fial systari operation* diskettes with different 
densities m^i be freely inter chariqed* 

c) Softyare support for hardware detectiori of Hettory parity arid iiefiory 
reply ti?ie-out* 

Software support for yinchester disk on ME1600 series* 

s) Sysqen capability to specify Hmchester configuration for nui^er 
of VQlu.^es* See SectiOTi 6*13 of 111*0 Software Marniai and Appendix 
A of this docuF^nt for details* 

b) Muiiber of disk visluf^es increased fro« rtaxlMUfi of 8 to a rtaxmurt of 236* 

c) Autofiatic incorporation of Hinchiester UQ driver if there is a 
Winchester drive on the systefi* 

d) Softusre controlled sinqle-double density selectiori* This feature 
requires th« floppy disk controller card be upqraded to ^lardware level B3* 

Enhanced console I/C capability* Ojtput to a CRT is now twice as fast 
en 12SK~byte snstef^s as previoijs releases* 

Hu!nber of directory accesses lowered by Hore efficient aiqorithsn handiino 
dirsctory lookup* 

Systef-s confiQursbility for the operating systeri by nesns of 128 segfient 

cB^aDility and segfient processes which are used for system configurability* 

The H3 systefn is confiqursd for the class of ter^irisls including the 
Soroc mm and the nt^BX Dialog SO* For users with Volker-Craig ^cdei 

i.-_..j •_ .:i_i_ jL-f iu_ ! :. _J i.'.._ i J T !-_ __i J. _ Arv^ n »_ 

"^at-ier thsn vK^!}'i rcde* In this node* the Volker-Craig terfimal e^iuiates a 

jU! ^^C -.rSrnli.c.i* ='?CvC vlfsit ^nS UeUurdt-c Si^ltCn Un tiiS UcCK UT ^ icJ 

ifelker-Craiq terminal snould be bet to %00 baud* 

Diagnostics run du^mq boot w with output indicating any faults as a 

Hessage to us?r. See Appefidix G of the 111*0 Software Hanual for details* 



Tiri8k8t'Per proc-sss for HElcOO SH'StsH to sllow access to systen cloctu 
See Secticcf 7*5*5 of the III*0 Software Hsris-ial for Hore detsils* 

Protection durinq diskette rsMcvsl so t^3t the correct diskette is on line 
duriny losdirsg of o'^rla'^sule code seowerits* If the 'C'oot diskette is not 
on-line yhefi requiredj the operstinq s^sten will prcsipt yith "Insert 0SH3 
in drive 4* Type <sp3ce> t^en ready or <e5C> to ^ort"* If the diskette 
yith a use? prcQras is not cn-lirs* thie operating system will prcttpt with 
"Insert PF^OGF^AH dis-kette in drive _♦ Type <^3ce> whers ready or <e5c> to 
shortt'% where thse correct drive nuft^r will be displayed* T'ypinq space 
with the correct disk.ette ori line will csjse the required code seqwent to 
he loaded* For eKaj^ler removal of the system diskette durinq editing 
will fiot now caitse a system hanq* 

Thie system is shipped wit-h a SYSTEM* MISCIhFO for disk dri^/es that have at ie 
least 3 h fts* seek rate* For systeis with slower drives* a secorid file* 
SLOy*HISCBFO* is supplied* This has a 15 «s* s-eek rate* If your system 
h5s slow ^i± drives, chariqe SLON*HIS:iNFO to SYSTEH*HISCir'rO or. the H3 
diskette artd then toot* 



■f'ew Feature Detsils 

Operstinq Systefi 
128 Seqf^ents 



Tiie H3 software release extends thie 123 seqferit capability to static 
^sy5tel^ seqrient vector) as well as vectored (user seqwent vector) code files* 
Prior to the H3 release » programs coj^iled with the l-U- directive were 
restricted to 16 ssq-sents (0 to 15)* Hith the H3 release? these proqratts 
nay now contain up to 128 seqfients (0 to 127)* 

HOTEt Since $^J- proqrsfis use the systes sequent vector st run ti^e, they 
fiust coeHist non-destructiveiy with the operatinq systefi-'s seqtients* Thus to 
E-vcdd rsplecinq operatinq systen seqfnSTfts by %}- proqraei seqrfintSf all $U- 
proqra??s should declere dufitty seq^ents for any seqfient in use by the operatiriq 
system* Th;e only seqf^ents quarsnteed W\ to be operatinq system seqwents are 
seqjients 1* S* J5* ThsreforSj any $U- proqrsji which includes seq^ents other 
then these say not be capable of coe'/Qstinq non-destructively with the 
operatinq systems* 

This extension is upward cowpatible in that any code file qenerated by 
r el eases prior to H3 will run under H3* 

I Th;e intrinsic FILLCHAR has been opti?iiied* It is up to 15 tif^es faster 
*i ■.ban in previous versions* 

Tf-p serial ?ort control registers f*ay riow be altered by a user proqratt 
without conflict with QPeratiriq.systefs operation* For exasplei parity rtay be 
enabled by alter inq the controll register in the HD1931 USART* Operatirsq 



ofih* lbs RTS bit is sltered during i^rite operdtions^ but 3ll other control rsgi 
register bits «3y te altered without the cpersting systefi overriding changes* 



Soot Seqi.ience 

H-je SB16S0 and the ¥Eim with Wirchester support allow a bootable 
floppy disk, to be inserted in any drive for boct-ip* For a typical two 
drive systef** bGotirtg for-M the left drive causes the boot mit to be HI ar^d 
booting fron t-hie right drive causes the boot iriit to be t5tt 

See Section 6*13 of thie 1X1*8 Software Il3rjj.i3l for details* 

Debugger 



Ti-ie Debugger has been ershariced as followst 

a) Mefiory Gijtput ttay be viewed as decittai* hex* binary* ascii* or 
msigned decifial* 

b) HeHory output display fiey be targeted to ariy file or device* 

c) iiejiory output Hay be stopped by hitting any character* 

d) The C(h3in QomBrd has been erihareed to aijtoftaticaliy display all 
I Is of call in the i^srk stack. coTitrol yord chain for either static or 
!%, .cfMic link ficdei* 

e) The O'ffset comand has been a-ihanced to display the address and 
contents of offsets fro« the cwrent HP* 

f ) A new ccfiHand T(3sks has been B^iiBfi in X(artine node* This allc^ws 
the display cf all user t-asks in the system* Th-e C'.hem cofifiard can then 
be used to inspect each tasks riark stack. coTitrol word chain* 

g) Thie S(t.atus ri:=f**^snd now displays the entire Task Information Block 
and the t554h queue arid system segfient vector pointer* 

h) The Debugger is a SEGMENT PROCESS which allows Hore flexibility in 
debugging prog?a?*s with tasks as the Debugger no longer needs be loaded in 
the stack space of a task to be debugged* This frees the user fro« havirig 
to increase a task stack size for debug purposes* 

See section 6*15 of the 111*0 Software Hanual for details* 



ThiH Copy progrsH performs background file transfers, whale the syste« 
^ay be I'sed to 62 rior?^al work in the foreground* The H2 version of the 
Copy progrsfi required a field Manipulated by Setisp for Copy usage* This is 
rsot required for H3 operation* Note due to the nature of asyrichroriOLis tasks* 
if 3 foregro^jnd progrsH writes to the sstie destination file as trie Copy 
PT-ograri the output of the two tasks will be intermixed* 



123 static seg?5ent5 upgrade * 

See Section 6*7*3 of the 111*0 Software nanuaL 



H&^iient procssses 

The constfiict SEQiQ^T PRSXSS is ii^lefented m U& H3 rslesse* 
ITiis cspsbility allows processes to be started so that their code is residerit 
only when the task is started* liowe^/sr when a segient process tsr-ttinates its 
code is ret sistcfistically deallocated* The space cari be ifeailazated b'i use of 
the HARK and FELEftSE intrinsics* In order for these to work.* no other tasks 
in the SHsteM fiay do a NEH to allocate froH the heap* If no NEH is executed 
then b'-j doing a mi', before the START of the SEGMENT Ff^GCESS arid a release as 
the last statement of the SEGsCNT FflCS^EBS, the mrnvH spac-e «3h be reclaimed* 
Note also that if this is to be dorse for tyo SEGICNT PROCESS'S the order of 
HARK 3rd RELEASE for each process «ust be s^^ttfetric* 



Librarian 



The librarian has be^i Modified to ss-ipport static 128 se^^nt cocte 
files* Protocol for dealirsQ with static 128 segment code files is iderAical 
to that pertainiffQ to vectored 128 segHent cocfe files (see Sectiwi 6*5 of the 
m.O Software Haniiel)* Thie user interface has been fiodified sli^itlij to 
allow <e5c> alternatives at points where the user was previouslij cowitt-ed to 
actions that mn not h3*,«'been desired* 



LimndP 

Libfap has been is^dated to s.ipport static 128 seqrient code files* The 
chsnqes are functional only* The coma"id5 seen by thte user sre irtchanged* 



SHsterSi Library 

A rsw unit, DELAYUNIT* has been added to t-he systew library* Operatirtg 
sMstep* support routines for this unit are loaded only for systems with 
123 Kbyte iieMory =4:' ace J systems, with 61 Kbytes do rat ssjpport this feature. 
See section 7*5*5 of the 111*0 Software Hsr^jal for details* 

OisasM 

Tiie Disassembler has been updated to shipper t static 128 sequent code 
files* Tlie changes are funct-ional only* Thie coMHarids seen by the user 

are unchanged * 



Two new fields have been added to Setup* The first is 'HAS NO 
INTERRUPTS"' i This field replaces the field 'HAS 8510A' which had no fieeniny 
f/ he Hicroenqine* The new field is nori^lly false so the syst^ri runs 
A .iTUot driven* If this field is set true then non-interrupt I/O is 
perfoTHedt This can be useful in diaqnosina problefis m the mterri.ipt sub- 
system? but should be Set false otherwise* 

The second field 'HAX SERIAL PORTS' is norfially set to 0* This field 



CDTitrolE. the j^3)<mM mit'Bf of serial ports sijppQrt-ed b'j VQ driver processes* 
ft tte3ns use the defsult rwttber for the sechirse* This rw^ber is 2 for tihe 
SB1600 end the HD09Q0 and 4 or 8 for the (€1600 dsperiding m Vcs nuttisr of 
ssriBl CBfds instslled* By setting 'MAX SEF^L PORTS' to na-nero and less 
then the H3>d?ii.ittf tJ-ie I/O drivers for thiese ports are not loaded* This cbti 
save aboiA 170 words for port driver rtot loaded* Onlij when mmf'i space is 
limited is it recoiiiTsrided that this field be romsrot 



Editor 

Hith t^iS H3 systeHj the mrMal screen editor is still SJjpported* 
Hoyever a new editor, (^V* EDITOR » is also iriciiided* For details of its 
j.!S9 see Section 3*2 of the m*Q Software Hariual* 

Filer 

The Filer rtow dster-ftines the size of a voii^ie for the Kero arid B(3d 
block scan cfflifisfids* This allows ihe filer to indicate to the user the 
mximn TL^bBT of blod<.s a disk-ette He'd ^i5we sr^ thie m-ittber of blocks a bad 
block scari will co'v^r* The BCad bloc^. scari cofBiand ricw allows a bad block 
scan for a block ranqe as a iiser opticri* Iri additicffi if a bad blcsk is 
found* thie Filer will ask. if m E(Ka^ine operation shiould be performed* in 
I r to attettpt to cure the bsd block* 

The VColiifies cQjiftarid now iridicates whether serial sr^ parallel I/'G 
devices are on-line* A unit r^-uifcter in parentheses irtdicates the unit is mi 

on-line* 

A -voluRe to volufie transfer on an H£i600 system between two volii^es ori a 
Winchester disk unit will now ask for a new nesie for the destinatiorj volutte* 
This is i±ine as duplicate s^lujie rss^es cause file access aftbieuity* 



Buq fixes 

Operating SystsM 

Hhsn reading an integer , PIACO m longer ecrioes wlien it is waitirsg 
for end of line* Only the EOL character will be echoed* 

Hewory jiansgefient roijtine-s fiow use the directory lock to assure orie 
task does not destroy anothier task's directory copy* 

Pascal cofipiler 

a) The coripiler now generates error tl91 if a file is declar&j in th£ 
ifipleftentaticn part of a unit* mis error is necessary s-s file 
initidliidtion code fiay only be generated if thie host program [;jiow5 at 
co?pil£ tif« of the existence of a variable* Files declared in the 

interface are thus allowed* 

b) T]"r5 CQripilsr T-Qy generates correct code for the expression ♦*♦ 'a' 
<relop> ch *** * For exariple t '"■'■' <= ch where ch is of type char 



c) The CQf^ile? rioy generstes correct code for the ej-qiressitriS 
■'3' in I'eS/z'] ♦.♦ sr^ *♦+ -'s' in c-hset ♦ 

d) H-;e compiler re Icciger- errofieousiij gsnerstes error #117 for the 
following forward t^e reference I 

t^.Fe 3 = ^y.i 

c = ^ij 
\i — ♦ 

A — * i i * i t 

T — ^ 



e) The coripiler ro longer- suffers 3 vskie rsnge error 
when the fcllowinq is encoiriterd in 3 Pascal progrsttJ 

coffst nl = -if 
ore = IJ 

t i 4 « i i » 

if i in [ni**orie] then ♦♦♦♦♦* 
notsJ The correct code cssjses 3 valiie rsTi^e error at vwi tiiie* 



f) Trie cof^iler gerierstes error #101 for the corsstntctl 

procedure xl forwardJ 
seofient procedure kJ begin ♦♦• 

•2) Fixed 3 "b3d list traversal" probleM in -Clu-J uses situaticrts* 

h) FiKed PHACHINE so thst the construct «variable» now works correctly 
for 3II sizes of -(varisble)-* previouslM* sizes > 1 Icsded only the 
first word* 

i) Fi;<sd PHACHIHE =0 th3t error 203 is qsnersted when constants greater than 
255 sre genersted* This is dorie ss PHACHIrC ewits opcodes which are 



Winchester Disk Support on the HE160Q Series 






The H3 release supports Hinchester disk drives on the r!E16uO product 
line. Note thst H3 requires the latest version of boot PROH's as these PROH's 
have 3 boot fron floppy and Winchester capability ♦ Since a Winchester disk 



nas 50 rtsjcn mvB spscs msn 3 rioppy qisk.? s Hincnester aisK. fisy oe 
psrtilioried into riultiple volumes* Iri order to flexibly preforri this 
psftitioninQj each Winchester disk hss 3 corifiQi.5r3ti«-t record on trecR that 
describes the wluMe parti tionirtg* Floppy disks May siso hsve 3 corifiquration 
record, but 3 confi^irstion record iwyjld be put on 3 floppij only for soMe 
special 3nd unusual purpose* If 5 floppy disk hss m confi^-irstiori record 
then the config.ir3tion defaults to drives 4j5.*9-H as flcspy disk volufss and 
fiO Hirchester wluwes* 

This docuiwnt will cover confiqijrstiori of 3 rew disk? HFORFATj COMT!GURE, 
and EsdITHAKE programs and migration of files frofi H2 based Hinchiester 
systems* A detailed description of the iise of these pro^rsn to configure 3 
SHstert is then shown* 



uverviey 

At boot thfi ME160Q will first sttei^t to boot froii sriy floppy disks on 
lirie* If no floppy disks sre ori line? thse system will boot frc<tt the 
Hirchester disk* If a floppy disk witho«jt a boot is on lirie thisn the systew 
yill attempt to boot from it* However the lack of a boot will casjse booting 
to fail* Tnerefore qbts mst be taken to assi-ire thsat floppy disks sre not on 
line when bootiriQ frow Winchester is desired* 



Hith H3 a Hircihester disk's volufies or a floppy disk «sy be sriy unit 
nuHt^er* This allows the boot irdt to be a^iy irdt mftber, not just irdt *^* 
It is recQj*.fiended that when c-onfiquring a Winchester disk with the COrdGURE 
pfograH that the Winchester disk volujies be in the range 28* .255* This is 
reconjiended as floppy disks whdch have no corifigiiration records (aLiost ail 
floppy disks will be in this state) are unit tl* Thds causes a conflict if 
the Hirctfester is also mit #^ causing the systew to be unable to read trie 
floppy disk* For fle;dbility in reading floppy disks, it is recoRfsended that 
the Hinchester irdts not t-e unit ♦'t or mit #5* 

Another reco{i?eridation is to create so«e voiu^s ori the Hirc-hester tihat 
have tte 5e?*e mmsf of blocks as 3 floppy disk* This allows a voii^ie t-o 
volume transfer bet-sen floppies and a Winchfister* Note that voli.ifie to volune 
transfer between Winchester and floppies does not transfer the bootstrap* 

To configure a new iriforttatted Hinc-hsesl^r drive the following steps Must be 
followedt 

1, Boot up the H3 system floppy disk* 

2* X(ecute WprrRHAT to format thie Hindiester disk* After the Hirchester 
disk is formatted the IfORNAT program writes a cccifiguration rec-ord to track 
of the Hinche-ster disk being forjiatted* The configuration record produced 
by HFORMAT describes the nijiiber of heads and cylinders the Hincfsster disk 
i iins* A 10 m Winchester disk has 2 hssds* 512 cylifiders, ard (2 s 512) = 
L_. tracks each holding 16 blocks* The 10 HB disk has (16 a: 102'^) = 16K 
i;^ n^ 8 HB of useable data space* A 40 HB Hinchester disk hss 8 heads, 
dsrs* and (8 * 512) = 4096 tracks each holding 16 bloc-ks* The ^Q HB 
disk has (16 % W6) - 6^K blocks or 32 ?£ of L^seable data space, 



u 



volu«e5» Ths CO^FIGURE progrsji edds this voli.ife confiyuraticn infornaticn to 
the configure record initislly crested bi ^QRHAT+ fete the CONFIGURE progrsM 
will not run on systsfs yithi less thsn 128 Kbytes of «efiorHt 

^4 Reboot the systeM so that the rswiy crested confiqisrstion record can 
be TBsd in by the operatinq system t 

ji X(fr:ute BOOTHAKE to install 5 boot on the Hinc-hester disk.* The 
codefile E130T is the bootstrap t-o be placed on the Winchester disk by 
BOOTNAKE* 

6i Go to the filer s-id Z(ero the lowest Lwdi nufiber m the Hirchester* 
Then transfer all files froft the H3 floppy to t-he J^irchester volurie nearest 
the start of the Hirdiester disk, 

7* Reboot the systew yittojt a floppy disk, on line 4 

Migration frott H2w t-o H3 on Hinc-hester systens 

Me in order to use the H3 system which (toes S cor^lete boot frott 
Hkichester^ new rWiWs msi be installed in tl^ terwinator card* Thiese PROH's 
t jicliided i4ith the H3 release for H2w custoiiers* Users who have used Vr\e 
^'H system on Hirichester disks nay convert to H3 by either of the following 
prccedi.iresl 

A* Copy all files to te saved frott Hirchester to floppy disk* Now that 
all files are backed up follow the directiofiS for initieliiirtg a Hinchester 
diskt This entails reforfiattir!^ the disk, thus requiring all irtportarit files 
to be saved* 

B* If it is inconvenient to save all files on Hirchtester to floppy then 
use of the following procedsjre will preserve existing files* 

1* Boot i^ the H3 flop-py disk* 

2i X(scut-e Configure* 

3* Type '•''' and Corifigure will display* 

Convert H2 configuratiofi record to a H3 record ? 

Type -'y ard Configiire will display^ 

Unit to convert is F( loppy or ?l(inchester ? 

The Winchester is to be configured so type 'W * 

Cnnvpft Winchester drive [8,, 33 ^ 

T^!i5 pro?iPt ssK.s which drive on line to configure* For 3 single 
(tivi3! SHstm the drive on line is drive 0* Enter 0* 



the Confiqurs proqrsfi displays the H2 confiourstion* Hinchester units 
will be urdt nufibefs in the rsnqe 4**H* In order to 3*^-oid corifllct 
in H3 these unit mfibers s-hould be changed to unit nmbers in the 
rsfios 28**255 (see ne>rt step)* 

5* Type 'E' for E(dit theri '?' for PCrint record to display the H2 

confiQUTBtion* 

Type 'W for WCinchester to modify Hinchester units* Use the 
CChenge co/if^srid to chm^ mil nuftters ^nl^ to mit rn-ijibers in the 
vsr^ 28»t255* Theri HCrite otjt the new ccnfieur-Btion record* 

-6* Refctuot frod the H3 floppy* 50 to FCiler ^d observe that the H2 
voluries sre on line* 

7* X(ec!.!te Bootttske to plsce 3 H3 boot ori the Wincihester* 

8* Reboot the system witto.it 3 floppy on lirie* 



